Agregar eventos a subscripción

• Introducción
• Ejemplo de uso
• Ejemplo de respuesta
• Parámetros que recibe

Eventos

Para agregar eventos a una suscripción debemos agregar un token en Headers de tipo Authorization con el token necesario, este token deben solicitarse a Domus.
Es importante anotar que los parámetros deben ser enviados a través de algo como form_params o similar, no se deben enviar directamente en la URL.

Ejemplo de uso

{success} POST: /api/webhooks/subscribe/events

//Ejemplo Bearer

use GuzzleHttp\Client;

$client = new Client();
$res = $client->request("POST", "{$endpoint}/api/webhooks/subscribe/events", [
    "json" => [
        {
            "subscription_id": 1,
            "events": [1]
        }
    ]
]);

$subscription = json_decode($res->getBody(), true);
return $subscription;

Ejemplo de respuesta

{
    "code": 200,
    "message": "Eventos modificados correctamente",
    "data": {
        "id": 1,
        "integrator_id": 1,
        "target_url": "https://palomma.co/webhooks/receiver",
        "auth_mode": "bearer",
        "is_active": 1,
        "created_at": "2025-12-10T19:14:24.000000Z",
        "updated_at": "2025-12-10T19:14:24.000000Z",
        "events": [
            {
                "id": 1,
                "name": "Create Contact",
                "slug": "contact.create",
                "description": "This Webhook will create a contact in the system configured in the subscription",
                "created_at": "2025-12-10T05:00:00.000000Z",
                "updated_at": "2025-12-10T05:00:00.000000Z",
                "pivot": {
                    "webhook_subscription_id": 1,
                    "webhook_event_id": 1
                }
            }
        ]
    }
}

Ejemplo de respuesta fallida

{
    "code": 400,
    "message": "Faltan campos o requieren correcciones",
    "errors": {
        "events.0": [
            "Uno de los eventos enviados no es válido o no existe en el sistema."
        ]
    }
}

Parámetros que recibe

Por Form Params o Json

Estos son los valores requeridos para la creación del usuario